ОТРИМАННЯ ПРИКЛАДІВ ДЛЯ ТЕСТУВАННЯ¶

Оскільки тести є насправді віртуальними машинами, ми поділили їх на дві групи: тести, які поширюються вільно, і тести, які є пропрієтарними. Перші є образами, подібними до образів Fedora або CentOS, які є вільним програмним забезпеченням. Другі — образи, які подібні до образів Windows або Red Hat Enterprise Linux.

Вільно доступні і поширювати тести можна отримати тут: http://git.annexia.org/?p=virt-v2v-test-cases-free.git ще не є доступними

Пропрієтарні тести можна отримати зі сторінки http://git.annexia.org/?p=virt-v2v-test-cases-nonfree.git У тестах не міститься самих образів пропрієтарних систем, які з причин ліцензування не є загальнодоступними.

Тести є образами дисків із дуже великими розмірами — від 250 МБ до десятків гігабайт кожен. Це означає, що поширення тестів може бути дуже тривалим і вимогливим до ресурсів завданням. Ми використовуємо для поширення образів тестів git-annex(1).

ВИМОГИ¶

Для тестування рекомендуємо використовувати бездіяльну машину. Для виконання тестів вам знадобиться доволі багато вільного місця на диску, більше 100 ГБ. Крім того, на тестовій машині має бути багато оперативної пам'яті, принаймні 16 ГБ.

ОТРИМАННЯ КОМПЛЕКСУ ДЛЯ ТЕСТУВАННЯ¶

Для запуску тестів вам знадобиться комплекс тестів virt-v2v.

Модуль OCaml називається "V2v_test_harness".

Найпростішим способом є зібрати libguestfs з початкових кодів (Зауваження: не встановлювати її). Тестовий комплекс зберігатиметься у "libguestfs/v2v/test-harness"

Крім того, комплекс тестів можна встановити як модуль OCaml.

ВИКОНАННЯ ТЕСТУВАННЯ¶

Щойно ви отримаєте вільно розповсюджувані тести зі сховища, віддайте такі команди:

 ./configure [--with-test-harness=/шлях/до/libguestfs/v2v/test-harness]
 make
 make check -k

Рекомендуємо скористатися параметром -k, щоб тестування не зупинялося після першої ж помилки.

ПАРАЛЕЛЬНЕ ТЕСТУВАННЯ¶

Запустити тести паралельно можна за допомогою такої команди:

 make check -k -j<N>

(наприклад -j2, щоб запустити 2 тести паралельно). Будьте обережні із паралельним запуском надто великої кількості тестів — це може спричинити помилки, які не пов'язано із помилковою роботою бібліотеки.

ТЕСТУВАННЯ ОСНОВНОЇ ГІЛКИ РОЗРОБКИ VIRT-V2V¶

Використання "make check" призведе до використання виконуваного файла "virt-v2v", який зберігається у одному з каталогів зі змінної середовища $PATH.

Якщо вами було зібрано libguestfs з початкових кодів і ви хочете перевірити зібрану версію virt-v2v, скористайтеся скриптом libguestfs "run" (зберігається у каталозі збирання верхнього рівня у каталозі із початковими кодами libguestfs). Приклад:

 ../libguestfs/run make check -k

ФАЙЛИ КОЖНОГО З ПРИКЛАДІВ ДЛЯ ТЕСТУВАННЯ¶

Кожен із прикладів для тестування складається з таких компонентів:

тест.img.xz

Образ диска віртуальної машини до перетворення. Зазвичай, його має бути перетворено у простий формат (raw) і стиснуто за допомогою xz.

тест.ova

Крім того, можна скористатися OVA, експортованим з VMware.

test.xml

XML libvirt, який використовується як вхідні дані virt-v2v. Див. обговорення щодо -i libvirtxml на сторінці підручника щодо virt-v2v(1).

test.ppm

Необов'язковий знімок екрана або знімки екрана.

Ви можете не надавати «відомі правильні» знімки екрана, надати один або декілька таких знімків, які відповідають проміжним крокам завантаження гостьової системи. Корисно робити такі знімки на етапах, коли гостьова система виконує якісь тривалі дії. Це надасть комплексу тестування дані, за допомогою яких він зможе визначити, чи слід дозволяти гостьовій системі продовжувати завантаження.

Ви можете не вказувати «остаточний» знімок екрана або вказати один такий знімок. Це часто знімок вікна входу до системи, який вказує на те, що гостьову систему було успішно завантажено.

Знімки вікон створюються за допомогою virsh(1). Порівняння знімків вікон із еталонними знімками виконується за допомогою програми compare(1) з комплекту ImageMagick.

test.ml

Сам приклад для тестування — див. нижче.

НАПИСАННЯ ТЕСТУ¶

Файл тестування (*.ml) використовується для керування комплексом тестування. Його мінімальна версія виглядає десь так:

 open V2v_test_harness
 
 let test = "short_name"
 
 let () = run ~test ()

Це має проінструктувати комплекс тестування про те, що слід:

• Розпакувати short_name.img.xz
• Запустити "virt-v2v -i libvirtxml short_name.xml [...]"
• Завантажити отриману гостьову систему і перевірити, чи виконує вона запис на свій диск і чи стає після цього диск бездіяльним.

Вище наведено надто спрощене тестування. Реалістичнішим варіантом був ви варіант із перевіркою того, чи гостьова система досягла остаточного етапу завантаження (за знімком), наприклад сторінки входу до системи. Для реалізації такої перевірки вам слід вказати параметр "~test_plan":

 open V2v_test_harness
 
 let test = "short_name"
 let test_plan = {
   default_plan with
     boot_plan = Boot_to_screenshot (test ^ ".ppm")
 }
 
 let () = run ~test ~test_plan ()

Ще надійніший варіант тестування можна створити, якщо виконуватиметься тестування після перетворення і після завантаження із перевіркою образу диска (за допомогою libguestfs) з метою переконатися, що у образі диска у очікуваний спосіб створюються, змінюються та вилучаються файли. Щоб дізнатися більше про те, як цього досягти, ознайомтеся із вмістом файла V2v_test_harness.mli.

ФАЙЛИ, ЯКІ СТВОРЮЮТЬСЯ ПІД ЧАС ВИКОНАННЯ ТЕСТУВАННЯ¶

Під час виконання тестування може бути створено такі файли:

test-yyyymmdd-hhmmss.scrn

Знімки графічної консолі гостьової операційної системи. Такі знімки корисні для написання тестів або діагностики помилок під час тестування.

Форматом знімків екрана є Portable Pixmap (PPM).

test.img

Нестиснений початковий образ диска (до перетворення).

test-converted-sda

test-converted.xml

Результат перетворення, тобто стан після виконання virt-v2v, але перед тестовим завантаженням гостьової системи. Див. сторінку підручника щодо virt-v2v(1), щоб ознайомитися із описом параметра -o local.

Формат образу диска — qcow2.

test-booted-sda

Образ диска після тестового завантаження. Це файл qcow2, у якому з метою заощадження місця на диску використовується як диск резервної пам'яті файл test-converted-sda.